ShowTable of Contents
DISCLAIMER: IBM Lotus Notes Domino R8.5.2 is pre-release software so there is no guarantee that what is written below will be part of the final release.
Here is a list of the new XPages features and enhancements, some big, some small, coming in 852. It's an A to Z with one-liners (a little rough now, some with placeholders - we will get to those in time), with links to existing articles and blog posts.
So here goes...
Accessibility
ARIA Support
ARIA support (includes the role property added to many controls) - the role property implements the W3C ARIA specification on roles at
http://www.w3.org/TR/wai-aria/#Using_intro.
As of release 8.5.2, most XPages controls contain a
role property which is accessible by clicking
All properties on the
Properties tab. This property is a literal string or a computed value that returns a string.
The role property implements the
W3C ARIA specification on roles
. Screen readers such as JAWS use roles to acquire contextual information about HTML pages. For valid values, see
http://www.w3.org/TR/wai-aria/#roles.
WAI-ARIA provides Web authors with the following
- Roles
- to describe the type of widget presented, such as "menu," "treeitem”
- to describe the structure of the Web page, such as headings, regions, and tables (grids)
- Properties
- to describe the state widgets are in, such as "checked" for a check box, or "haspopup" for a menu.
- to define live regions of a page that are likely to get updates (such as stock quotes), as well as an interruption policy for those updates—for example, critical updates may be presented in an alert dialog box, and incidental updates occur within the page
- for drag-and-drop that describe drag sources and drop targets
Roles, States & Properties
An ARIA role is set on an element using a role attribute.
For example,
1: <li role="menuitem">Open file…</li>
ARIA provides a collection of accessibility states and properties which are used to support platform accessibility APIs. Changes in states or properties will result in a notification to the assistive technology, which may alert the user that a change has occurred.
For example,
1: <li role="menuitemcheckbox" aria-checked="true">Sort by Last Modified</li>
Active Content Filter
The ACF has been upgrade since 851. The version in 852 is 2.4.0
Agents
Agents with In-Memory documents
Java Agents in XPiNC
XPages in the Notes Client, Release 8.5.2, supports calling Java Agents to run locally on the Notes Client. Previously, only Agent.runOnServer() was supported where the NSF containing the XPages application and Java Agent were stored on a Domino Server.
More details can be found here,
Running Java Agents from XPages in the Notes Client. The key information is summarised below.
In Release 8.5.2, XPages support for the Java Agent APIs on the Notes Client is the following,
| Client Type |
NSF Location |
Supported Agent API |
| Agent.run() |
Agent.run(String noteID) |
Agent.runWithDocumentContext(Document doc) |
Agent.runWithDocumentContext(Document doc, String noteID) |
Agent.runOnServer() |
Agent.runOnServer(String noteID) |
| Notes Client |
Local Notes Client |
Yes |
Yes |
Yes, new API for 8.5.2 |
Yes, new API for 8.5.2 |
Yes, runs agent on Notes Client |
Yes, runs agent on Notes Client |
| Notes Client |
Domino Server |
Yes |
Yes |
Yes, new API for 8.5.2 |
Yes, new API for 8.5.2 |
Yes |
Yes |
Ajax
Partial Refresh Timeout
Set a timeout for partial refresh - "xsp.partial.update.timeout" - See this for a use case.
Prevent Filtering
Prevent-filtering property (TypeAhead preventFiltering property). The typeahead *always* automatically filters the entries based on the first characters sent by the browser, which prevent some use cases from working. For example, where you would like to show results from the first character on the second word. This new property prevents this filtering.
CKEditor
CKEditor - new default rich text editor to XPages. This is the new default Rich Text Editor for 852, though if you need to switch back to using the previous dojo editor, there is an option here to do so.
Controls
Editbox autocomplete
Support for the "autocomplete" attribute on the EditBox to help manage the setting and changing of passwords.
Radio Group & Checkbox Group
Radio Group & Checkbox Group - has been re-implemented in Designer
tagName
HTML tag support for Computed text (tagName Property). This allow the control to emit a tag for computed text, like h1, h2, h3 tags to aid in creating semantic HTML structures for documents (to help in search engine optimizations, etc).
Data Sources
databaseName
Better server name support in the database Name attribute. This allows the database to be deployed on different servers and run on the client, XPiNC, without having to update the databaseName property for each NSF deployed to each server.
Soft Deletes
Soft deletes support enhancement.
Designer
"Pretty" Panels
Most if not all of the 'pretty' panels have been enhanced. The widely used properties from the 'All Properties' tab have now been promoted to the more user friendly panels. See the Data panel for the View Panel control.
Source
Drag and drop to the Source pane.
Lots of other stuff...
Discussion Template
The Discussion template has gotten a further update in 852 so that it performs better and has a better user experience.
Documentation
For Release 8.5.2, the XPages user's guide in the product documentation has been revised. It now includes reference topics for all controls and properties. The overview and other material has also been redrafted. Work is on going to improve this guide.
Dojo
Upgrade
Upgraded to Dojo 1.4.3 for the server and XPiNC. The server install will also include a further upgrade to 1.3.x to Dojo 1.3.3.
Type and Attributes
Dojo Type and Attributes added to more controls (including scriptBlock)
dojoForm
Support for dojoForms (dojoForm="true")
Events
onClientLoad
onClientLoad Event. Its now possible to add scripts in the events to be executed when the page is submitted or this panel or some containing panel is partial updated.
Extensions API
Some are calling this XPages, The Next Generation, and this feature is one of the main, if not the main highlight for XPages in 852.
Current documentation on this Wiki - http://www-10.lotus.com/ldd/ddwiki.nsf/dx/Master_Table_of_Contents_for_XPages_Extensibility_APIs_Developer_Guide
Tim Tripcony's blog post on this - http://www.timtripcony.com/blog.nsf/d6plinks/TTRY-86X7KV
Declan Lynch's post - http://www.qtzar.com/blogs/qtzar.nsf/d6plinks/DSLH-8673BY
Global Objects
Two new Global Objects for Server Side JavaScript, sessionAsSigner (open a session using the signer rights) and sessionAsSignerWithFullAccess(open a session using the signer rights, while giving it full access to the data)
sessionAsSigner
Assigns credentials based on the signer of the of XPages design element. The session is restricted by the application's ACL and the security tab of the server's Domino Directory entry.
sessionAsSignerWithFullAccess
Assigns credentials based on the signer of the of XPages design element and allows full administrative access to the application's data. The signer must have the right to such access or the session is not created.
HeadTag
New resource xp:headTag - this allow you in an easy way to put stuff into the header of a XPage - and here is an example of it's use.
HTML5
Cache Manifest
Base Resource
HTML5 Base resource support - pageBaseUrl property renders as a base tag in the header. The tag specifies a default URL and\or a default target, for all elements with a URL.
Infrastructure
OSGi Framwork
The runtime has switched over to use the OSGi framework. All the XPages libraries (which are under xsp/nsf/lib in 851) have being moved to the OSGI framework under the shared eclipse location.
Miscellaneous
New complex-type "loaded" property
New support has been added for the loaded attribute to complex types. This will allow for a way to conditionally define a complex objects like a dominoDocument on an XPage.
OneUI
oneuiv2
A new version fully available - oneuiv2. Try out these new themes: oneuiv2, oneuiv2_green, oneuiv2_gold, oneuiv2_metal and oneuiv2_red.
Pagers
Last Page
Allows for the calculating of the Last page in a data collection for the Pager. In 851, there is a restriction on the number of pages the Pager will display. This is because of associated performance hit (this is still the case with this new property). However, customers have asked for an option to calculate this regardless. The 'alwaysCalculateLast' property, new to 852, allows you to do just that.
Performance
Further enhancements in the Java back-end classes help XPages perform better.
Repeat Control
Allow Zero Rows
Repeat Control enhancements - "xsp.repeat.allowZeroRowsPerPage". This option may be useful when you need to compute the number of rows to display as there may be situations where no rows should be displayed but the Repeat control should still render.
Security
Java Agents in XPiNC
XPages in the Notes Client, Release 8.5.2, supports calling Java Agents to run locally on the Notes Client. Previously, only Agent.runOnServer() was supported where the NSF containing the XPages application and Java Agent were stored on a Domino Server.
More details can be found here,
Running Java Agents from XPages in the Notes Client.
XPages ECL to Permissions updated to include more Java Permissions
In V851 of XPages, security for executing Java code in XPages in the Notes Client was very restricted. For XPages V852, the Java Permissions managed by the XPages ECL settings have been broadened to be similar to the set of Java Permissions allowed by Java Agents and to bring a level of equivalence between Java Permissions allowed for XPages on Domino Server (Unrestricted) and XPages in the Notes Client. For example, in V851 the ECL Network permission only covered the Java SocketPermission, now it covers NetPermission and other related Java network permissions.
Public Access
Public Access enables users to view (or create and edit) documents in cases where the user has not been explicitly granted access as either a reader or author of a particular document.
Up to now XPages applications were prevented from running if the user accessing the application only had the ability to read and write to Public Access documents. Now, in XPages Release 8.5.2, application designers can make XPages design elements available to Public Access users by setting the "Available to Public Access users" property in the Security sections of the Properties tab for an XPage.
Once an XPage has been made available to Public Access users, the user will only see
- documents
- that have been created from a form which the "Available to Public Access users" property set and
- also contain a text field named $PublicAccess with a value of 1
- contents of views
- that have the "Available to Public Access User" property set in the access control options for the view (and only those documents that are available to Public Access users will appear in the view).
More details can be found here,
XPages Public Access Support.
Managed Beans
Referencing a Managed Bean from JavaScript now supported in XPiNC. This fixes a bug where a Managed Bean, first referenced in JavaScript (which triggered the creation of the Bean) caused a security exception. The workaround was to first have this Managed Bean referenced and created as a DataSource (referencing the Bean from then on was fine). This bug is now fixed.
Single Copy XPage Design (SCXD)
Validation
disableValidation
View Filtering
Start Key
Very much like 'keys', startKey allows you to filter the view to start at a certain value.
Multi-level category
This is an addition to categoryFilter that allows you to filter a view by the category and then the sub-category.
Views and View Panel
Clickable View Column Header Icons
NotesXspViewEntry.setSelected()
XPages in the Notes Client (XPiNC) Integration
Running Agents in XPiNC
The following NotesAgent methods are supported: NotesAgent.run, NotesAgent.runWithDocumentContext, and NotesAgent.runOnServer. Security is based on the client ECL settings for the signer of the agent.
New Tab\Window management support
New Replica option
This menu option now available when an app is launched in XPiNC.
Open in Designer option
Menu option now available for a XPages app is launched in XPiNC
XULrunner upgrade
XulRunner in XPiNC has been upgraded to 1.9x, which is equalivalent to Mozilla 3.x.
window.close() support
Adds the ability to Close a Window from a Client Side or Server Side JavaScript event
- #